home *** CD-ROM | disk | FTP | other *** search
/ Programming Languages Suite / ProgramD2.iso / Borland / Borland C++ For TASM / TSM_RDME.TXT < prev    next >
Text File  |  1996-02-21  |  5KB  |  142 lines
  1. /***************************************************************************/
  2.                                  TSM_RDME.TXT
  3.                                TURBO ASSEMBLER
  4.  
  5.                  Welcome to Borland Turbo Assembler and Tools 5.0
  6.                  ------------------------------------------------
  7.  
  8. -----------------
  9. TABLE OF CONTENTS
  10. -----------------
  11. 1. Installation
  12. 2. New Features
  13. 3. Assembling and Linking with TASM 5.0
  14. 4. TASM utilities
  15. 5. Important Information
  16.    a) Object File Format
  17.    b) Out of Memory and MAKESWAP
  18.    c) Make under Windows NT
  19.    d) Creating 16-bit import libraries from .DEF files
  20.    e) Resource compilers: 32-bit command-line versions
  21.  
  22.  
  23. ----------------
  24. 1. Installation
  25. ----------------
  26. For details on installing Turbo Assembler and Tools 5.0, see the file
  27. TSM_INST.TXT
  28.  
  29.  
  30. ----------------
  31. 2. New Features
  32. ----------------
  33. New TASM 5.0 features:
  34.   - Enhanced MASM compatibility
  35.   - TASM32.EXE Thunk Compiler compatibility for Windows 95 flat thunking.
  36. New Turbo Debugger 5.0 features:
  37.   - Dual monitor support under Win95 (TDW: -do, TD32: -vd)
  38.   - Debugger support for new C++ language constructs (bool, namespaces, etc.)
  39.   - 16-bit debugging support under Windows NT with TDW.EXE
  40.  
  41.  
  42. ----------------------------------------
  43. 3. Assembling and linking with TASM 5.0
  44. ----------------------------------------
  45. The TASM 5.0 package includes three different assemblers:
  46.  
  47.   TASM.EXE           16-bit real-mode assembler
  48.   TASMX.EXE          16-bit protected-mode assembler
  49.   TASM32.EXE         32-bit protected-mode assembler
  50.  
  51. All three assemblers are capable of producing both 16- and 32-bit
  52. object files, depending on the directives contained in your assembler
  53. source files. If you produce a 16-bit object file, then you must use
  54. the 16-bit linker (TLINK.EXE) to link your application. If you produce
  55. a 32-bit object file, then you must use the 32-bit linker (TLINK32.EXE)
  56. to link your application.
  57.  
  58. TASM.EXE is a real-mode assembler, meaning that it is capable of using
  59. only the lower 640K of memory addressable by DOS. If you're assembling
  60. larger applications, use either TASMX.EXE or TASM32.EXE. Both of these
  61. assemblers use the DPMI server to take advantage of extended memory.
  62.  
  63. The biggest difference between the three assemblers is the type of
  64. debug information they produce when you assemble your source files with
  65. the /zi command-line option. Both TASM.EXE and TASMX.EXE produce
  66. only 16-bit debug information. TASM32.EXE produces only 32-bit debug
  67. information. If you plan to use Turbo Debugger to debug your assembler
  68. application, then you must assemble 16-bit files with either TASM.EXE
  69. or TASMX.EXE. To produce 32-bit debug information, then you must assemble
  70. your files with TASM32.EXE.
  71.  
  72.  
  73. -----------------
  74. 4. TASM utilities
  75. -----------------
  76.  
  77. TASM 5.0 ships with several debuggers and utilities to help you create and
  78. debug your assembly language programs.  For more information on Turbo
  79. Debugger and the tools provided with TASM, refer to the text files located
  80. in the DOC subdirectory located under your main TASM directory.
  81.  
  82.  
  83. -------------------------
  84. 5. Important Information
  85. -------------------------
  86.  
  87.    a) Object File Format
  88. ------------------------
  89.  
  90. Turbo Assembler generates object modules (.OBJ files) which conform to the
  91. Intel OMF (Object Module Format) specification.  In addition, the provided
  92. tools (such as TLINK32 and TLIB) and libraries accept only this format;
  93. there is no support in the linker or librarian for COFF object modules
  94. produced by Microsoft C tools.
  95.  
  96.  
  97.    b) Out of Memory and MAKESWAP
  98. --------------------------------
  99.  
  100. If you get "Out of Memory" errors from DOS when running the command-line
  101. tools, create a swap file with the MAKESWAP utility.  (Note that this
  102. applies to DOS only, not to DOS boxes opened under Windows.) MAKESWAP
  103. takes the size of the file to create in KBytes, for example:
  104.  
  105.     MAKESWAP 12000
  106.  
  107. will create a 12MB swap file in the current directory called EDPMI.SWP for
  108. use by Borland command line tools.  To enable the swap file, use the
  109. DPMI32 environment variable by issuing the following command at the DOS
  110. prompt:
  111.  
  112.     set DPMI32=SWAPFILE <location of swap file>\EDPMI.SWP
  113.  
  114.  
  115.    c) Make under Windows NT
  116. ---------------------------
  117.  
  118. If you encounter difficulties running MAKE under Windows NT, try running
  119. MAKER instead.
  120.  
  121.  
  122.    d) Creating 16-bit import libraries from .DEF files
  123. ------------------------------------------------------
  124.  
  125. Use the /o IMPLIB switch when you are creating 16-bit import libraries
  126. from .DEF files.  This prevents IMPLIB from generating extensions for
  127. import entry module names.
  128.  
  129.  
  130.    e) Resource compilers: 32-bit command-line versions
  131. ------------------------------------------------------
  132.  
  133. The 32-bit command-line resource compilers (br*.exe) that ship with TASM
  134. 5.0 do not run under 16-bit environments of DOS or Windows 3.1; you must
  135. run these 32-bit tools from the DOS boxes in Windows 95 or Windows NT.  If
  136. do not have access to Win95 or NT, you must use the 16-bit resource
  137. compilers (such as the ones shipped with TASM 4.0 or Borland C++ 4.5) to
  138. compile resources from the command line.
  139.  
  140.  
  141. /********************************* END OF FILE ****************************/
  142.